home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / X11 / XConfigureWindow.z / XConfigureWindow
Encoding:
Text File  |  2002-10-03  |  13.2 KB  |  286 lines
  1.  
  2.  
  3.  
  4.      XXXXCCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXCCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XConfigureWindow, XMoveWindow, XResizeWindow,
  10.           XMoveResizeWindow, XSetWindowBorderWidth, XWindowChanges -
  11.           configure windows and window changes structure
  12.  
  13.      SSSSYYYYNNNNTTTTAAAAXXXX
  14.           XConfigureWindow(_d_i_s_p_l_a_y, _w, _v_a_l_u_e__m_a_s_k, _v_a_l_u_e_s)
  15.                 Display *_d_i_s_p_l_a_y;
  16.                 Window _w;
  17.                 unsigned int _v_a_l_u_e__m_a_s_k;
  18.                 XWindowChanges *_v_a_l_u_e_s;
  19.  
  20.           XMoveWindow(_d_i_s_p_l_a_y, _w, _x, _y)
  21.                 Display *_d_i_s_p_l_a_y;
  22.                 Window _w;
  23.                 int _x, _y;
  24.  
  25.           XResizeWindow(_d_i_s_p_l_a_y, _w, _w_i_d_t_h, _h_e_i_g_h_t)
  26.                 Display *_d_i_s_p_l_a_y;
  27.                 Window _w;
  28.                 unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  29.  
  30.           XMoveResizeWindow(_d_i_s_p_l_a_y, _w, _x, _y, _w_i_d_t_h, _h_e_i_g_h_t)
  31.                 Display *_d_i_s_p_l_a_y;
  32.                 Window _w;
  33.                 int _x, _y;
  34.                 unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  35.  
  36.           XSetWindowBorderWidth(_d_i_s_p_l_a_y, _w, _w_i_d_t_h)
  37.                 Display *_d_i_s_p_l_a_y;
  38.                 Window _w;
  39.                 unsigned int _w_i_d_t_h;
  40.  
  41.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  42.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  43.  
  44.           _v_a_l_u_e__m_a_s_k
  45.                     Specifies which values are to be set using
  46.                     information in the values structure.  This mask is
  47.                     the bitwise inclusive OR of the valid configure
  48.                     window values bits.
  49.  
  50.           _v_a_l_u_e_s    Specifies the _X_W_i_n_d_o_w_C_h_a_n_g_e_s structure.
  51.  
  52.           _w         Specifies the window to be reconfigured, moved, or
  53.                     resized..
  54.  
  55.           _w_i_d_t_h     Specifies the width of the window border.
  56.  
  57.           _w_i_d_t_h
  58.           _h_e_i_g_h_t    Specify the width and height, which are the
  59.                     interior dimensions of the window.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXCCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXCCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           _x
  75.           _y         Specify the x and y coordinates, which define the
  76.                     new location of the top-left pixel of the window's
  77.                     border or the window itself if it has no border or
  78.                     define the new position of the window relative to
  79.                     its parent.
  80.  
  81.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  82.           The _X_C_o_n_f_i_g_u_r_e_W_i_n_d_o_w function uses the values specified in
  83.           the _X_W_i_n_d_o_w_C_h_a_n_g_e_s structure to reconfigure a window's size,
  84.           position, border, and stacking order.  Values not specified
  85.           are taken from the existing geometry of the window.
  86.  
  87.           If a sibling is specified without a stack_mode or if the
  88.           window is not actually a sibling, a _B_a_d_M_a_t_c_h error results.
  89.           Note that the computations for _B_o_t_t_o_m_I_f, _T_o_p_I_f, and _O_p_p_o_s_i_t_e
  90.           are performed with respect to the window's final geometry
  91.           (as controlled by the other arguments passed to
  92.           _X_C_o_n_f_i_g_u_r_e_W_i_n_d_o_w), not its initial geometry.  Any backing
  93.           store contents of the window, its inferiors, and other newly
  94.           visible windows are either discarded or changed to reflect
  95.           the current screen contents (depending on the
  96.           implementation).
  97.  
  98.           _X_C_o_n_f_i_g_u_r_e_W_i_n_d_o_w can generate _B_a_d_M_a_t_c_h, _B_a_d_V_a_l_u_e, and
  99.           _B_a_d_W_i_n_d_o_w errors.
  100.  
  101.           The _X_M_o_v_e_W_i_n_d_o_w function moves the specified window to the
  102.           specified x and y coordinates, but it does not change the
  103.           window's size, raise the window, or change the mapping state
  104.           of the window.  Moving a mapped window may or may not lose
  105.           the window's contents depending on if the window is obscured
  106.           by nonchildren and if no backing store exists.  If the
  107.           contents of the window are lost, the X server generates
  108.           _E_x_p_o_s_e events.  Moving a mapped window generates _E_x_p_o_s_e
  109.           events on any formerly obscured windows.
  110.  
  111.           If the override-redirect flag of the window is _F_a_l_s_e and
  112.           some other client has selected _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k on
  113.           the parent, the X server generates a _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t event,
  114.           and no further processing is performed. Otherwise, the
  115.           window is moved.
  116.  
  117.           _X_M_o_v_e_W_i_n_d_o_w can generate a _B_a_d_W_i_n_d_o_w error.
  118.  
  119.           The _X_R_e_s_i_z_e_W_i_n_d_o_w function changes the inside dimensions of
  120.           the specified window, not including its borders.  This
  121.           function does not change the window's upper-left coordinate
  122.           or the origin and does not restack the window.  Changing the
  123.           size of a mapped window may lose its contents and generate
  124.           _E_x_p_o_s_e events.  If a mapped window is made smaller, changing
  125.           its size generates _E_x_p_o_s_e events on windows that the mapped
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXCCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXCCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.           window formerly obscured.
  141.  
  142.           If the override-redirect flag of the window is _F_a_l_s_e and
  143.           some other client has selected _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k on
  144.           the parent, the X server generates a _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t event,
  145.           and no further processing is performed. If either width or
  146.           height is zero, a _B_a_d_V_a_l_u_e error results.
  147.  
  148.           _X_R_e_s_i_z_e_W_i_n_d_o_w can generate _B_a_d_V_a_l_u_e and _B_a_d_W_i_n_d_o_w errors.
  149.  
  150.           The _X_M_o_v_e_R_e_s_i_z_e_W_i_n_d_o_w function changes the size and location
  151.           of the specified window without raising it.  Moving and
  152.           resizing a mapped window may generate an _E_x_p_o_s_e event on the
  153.           window.  Depending on the new size and location parameters,
  154.           moving and resizing a window may generate _E_x_p_o_s_e events on
  155.           windows that the window formerly obscured.
  156.  
  157.           If the override-redirect flag of the window is _F_a_l_s_e and
  158.           some other client has selected _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k on
  159.           the parent, the X server generates a _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t event,
  160.           and no further processing is performed. Otherwise, the
  161.           window size and location are changed.
  162.  
  163.           _X_M_o_v_e_R_e_s_i_z_e_W_i_n_d_o_w can generate _B_a_d_V_a_l_u_e and _B_a_d_W_i_n_d_o_w
  164.           errors.
  165.  
  166.           The _X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r_W_i_d_t_h function sets the specified
  167.           window's border width to the specified width.
  168.  
  169.           _X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r_W_i_d_t_h can generate a _B_a_d_W_i_n_d_o_w error.
  170.  
  171.      SSSSTTTTRRRRUUUUCCCCTTTTUUUURRRREEEESSSS
  172.           The _X_W_i_n_d_o_w_C_h_a_n_g_e_s structure contains:
  173.  
  174.           /* Configure window value mask bits */
  175.           #define
  176.                     _C_W_X
  177.                                                 (1<<0)
  179.           #define
  180.                     _C_W_Y
  181.                                                 (1<<1)
  183.           #define
  184.                     _C_W_W_i_d_t_h
  185.                                                 (1<<2)
  187.           #define
  188.                     _C_W_H_e_i_g_h_t
  189.                                                 (1<<3)
  191.           #define
  192.                     _C_W_B_o_r_d_e_r_W_i_d_t_h
  193.                                                 (1<<4)
  195.           #define
  196.                     _C_W_S_i_b_l_i_n_g
  197.                                                 (1<<5)
  199.           #define
  200.                     _C_W_S_t_a_c_k_M_o_d_e
  201.                                                 (1<<6)
  203.           /* Values */
  204.  
  205.           typedef struct {
  206.                int x, y;
  207.                int width, height;
  208.                int border_width;
  209.                Window sibling;
  210.                int stack_mode;
  211.           } XWindowChanges;
  212.  
  213.  
  214.  
  215.  
  216.      Page 3                                          (printed 10/3/02)
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.      XXXXCCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXCCCCoooonnnnffffiiiigggguuuurrrreeeeWWWWiiiinnnnddddoooowwww((((3333XXXX11111111))))
  224.  
  225.  
  226.  
  227.           The x and y members are used to set the window's x and y
  228.           coordinates, which are relative to the parent's origin and
  229.           indicate the position of the upper-left outer corner of the
  230.           window.  The width and height members are used to set the
  231.           inside size of the window, not including the border, and
  232.           must be nonzero, or a _B_a_d_V_a_l_u_e error results.  Attempts to
  233.           configure a root window have no effect.
  234.  
  235.           The border_width member is used to set the width of the
  236.           border in pixels.  Note that setting just the border width
  237.           leaves the outer-left corner of the window in a fixed
  238.           position but moves the absolute position of the window's
  239.           origin.  If you attempt to set the border-width attribute of
  240.           an _I_n_p_u_t_O_n_l_y window nonzero, a _B_a_d_M_a_t_c_h error results.
  241.  
  242.           The sibling member is used to set the sibling window for
  243.           stacking operations.  The stack_mode member is used to set
  244.           how the window is to be restacked and can be set to _A_b_o_v_e,
  245.           _B_e_l_o_w, _T_o_p_I_f, _B_o_t_t_o_m_I_f, or _O_p_p_o_s_i_t_e.
  246.  
  247.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  248.           _B_a_d_M_a_t_c_h  An _I_n_p_u_t_O_n_l_y window is used as a Drawable.
  249.  
  250.           _B_a_d_M_a_t_c_h  Some argument or pair of arguments has the correct
  251.                     type and range but fails to match in some other
  252.                     way required by the request.
  253.  
  254.           _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of
  255.                     values accepted by the request.  Unless a specific
  256.                     range is specified for an argument, the full range
  257.                     defined by the argument's type is accepted.  Any
  258.                     argument defined as a set of alternatives can
  259.                     generate this error.
  260.  
  261.           _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  262.                     defined Window.
  263.  
  264.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  265.           XChangeWindowAttributes(3X11), XCreateWindow(3X11),
  266.           XDestroyWindow(3X11), XMapWindow(3X11), XRaiseWindow(3X11),
  267.           XUnmapWindow(3X11)
  268.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.      Page 4                                          (printed 10/3/02)
  283.  
  284.  
  285.  
  286.